package com.witmore.neutron.ai.mcp.server.trading.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.witmore.neutron.ai.mcp.server.trading.dto.ScorpionStockAbnormalRecordDTO;
import com.witmore.neutron.ai.mcp.server.trading.dto.StockAbnormalRecordResponse;

import java.time.LocalDate;
import java.util.List;

/**
 * 股票异动记录服务接口
 */
public interface StockAbnormalRecordService {

    /**
     * 分页查询股票异动记录（用于HTTP API）
     *
     * @param userId 用户ID
     * @param stockCode 股票代码（可空）
     * @param stockName 股票名称（可空）
     * @param abnormalType 异动类型（可空）
     * @param startDate 开始日期（可空）
     * @param endDate 结束日期（可空）
     * @param page 页码
     * @param size 页大小
     * @return 分页结果
     */
    Page<StockAbnormalRecordResponse> queryAbnormalRecords(Long userId, String stockCode, String stockName,
                                                          Integer abnormalType, LocalDate startDate, LocalDate endDate,
                                                          long page, long size);

    /**
     * 查询股票异动记录列表（用于AI工具调用）
     *
     * @param userId 用户ID
     * @param stockCode 股票代码（可空）
     * @param startTime 开始时间字符串（可空）
     * @param endTime 结束时间字符串（可空）
     * @param limit 限制返回条数
     * @return 异动记录列表
     */
    List<ScorpionStockAbnormalRecordDTO> queryAbnormalRecordsList(Long userId, String stockCode,
                                                                String startTime, String endTime, Integer limit);

    /**
     * 根据ID获取股票异动记录详情
     *
     * @param recordId 记录ID
     * @return 异动记录详情
     */
    StockAbnormalRecordResponse getAbnormalRecordById(Long recordId);

    /**
     * 获取股票异动预警详情
     *
     * @param alertId 预警ID
     * @return 预警详情
     */
    Object getAlertDetail(Integer alertId);
}
